# Get an asset

Retrieves a single asset by its unique identifier.

Endpoint: GET /v1/assets/{assetUuid}
Version: 1.1.0
Security: Bearer

## Path parameters:

  - `assetUuid` (string, required)
    The unique identifier of the asset.

## Query parameters:

  - `include[metadata]` (boolean)

  - `expand[metadata]` (boolean)

  - `include[files]` (boolean)

  - `expand[files]` (boolean)

## Response 200 fields (application/json):

  - `uuid` (string, required)
    Unique identifier for this asset.

  - `createdAt` (string, required)
    Timestamp when this asset was created.
    Example: "2025-11-23T14:15:22.123456Z"

  - `updatedAt` (string, required)
    Timestamp when this asset was last modified.
    Example: "2025-11-23T14:15:22.123456Z"

  - `removedAt` (string,null)
    Timestamp when this asset was removed. Null if not removed.
    Example: "2025-11-23T14:15:22.123456Z"

  - `archivedAt` (string,null)
    Timestamp when this asset was archived. Null if not archived.
    Example: "2025-11-23T14:15:22.123456Z"

  - `status` (string, required)
    Lifecycle status of an asset.
    Enum: "draft", "published", "unpublished", "archived", "removed"

  - `category` (string, required)
    Content category classification for an asset.
    Enum: "image", "video", "audio", "document", "design", "archive", "data"

  - `storageLocation` (string, required)
    Storage backend where asset files are stored.
    Enum: "s3"

  - `name` (string,null)
    Display name for this asset.

  - `description` (string,null)
    Optional detailed description for this asset.

  - `altText` (string,null)
    Alternative text for accessibility and SEO purposes.

  - `fileUuids` (array,null)
    Collection of file UUIDs associated with this asset. Populated when include[files]=true.

  - `files` (array,null)
    Collection of expanded file objects. Populated when expand[files]=true.

  - `files.uuid` (string, required)
    Unique identifier for this file.

  - `files.assetUuid` (string, required)
    Identifier of the parent asset this file belongs to.

  - `files.createdAt` (string, required)
    Timestamp when this file was created.
    Example: "2025-11-23T14:15:22.123456Z"

  - `files.status` (string, required)
    Upload status of a file.
    Enum: "awaitingUpload", "uploaded"

  - `files.variationType` (string, required)
    Variation type indicating the intended use of a file.
    Enum: "original", "thumbnail", "webOptimized", "mobileOptimized", "productDetail", "printReady", "socialMedia", "videoPoster", "videoPreview", "videoStreamLow", "videoStreamMedium", "videoStreamHigh"

  - `files.storageLocation` (string, required)
    Storage backend where asset files are stored.
    Enum: "s3"

  - `files.mimeType` (string, required)
    MIME type of this file.

  - `files.extension` (string, required)
    File extension of this file.

  - `files.storageSize` (integer,null)
    File size in bytes. Null if not yet calculated.

  - `files.checksum` (string, required)
    SHA-256 checksum for file integrity verification.

  - `files.isAutogenerated` (boolean, required)
    Whether this file was automatically generated by the system.

  - `files.presignedUrl` (string, required)
    Temporary pre-signed URL for downloading this file.

## Response 401 fields (application/problem+json):

  - `type` (string,null)

  - `title` (string,null)

  - `status` (integer,null)

  - `detail` (string,null)

  - `instance` (string,null)

## Response 403 fields (application/problem+json):

  - `type` (string,null)

  - `title` (string,null)

  - `status` (integer,null)

  - `detail` (string,null)

  - `instance` (string,null)

  - `correlationId` (string,null)

## Response 404 fields (application/problem+json):

  - `type` (string,null)

  - `title` (string,null)

  - `status` (integer,null)

  - `detail` (string,null)

  - `instance` (string,null)

  - `correlationId` (string,null)

## Response 500 fields (application/problem+json):

  - `type` (string,null)

  - `title` (string,null)

  - `status` (integer,null)

  - `detail` (string,null)

  - `instance` (string,null)

  - `correlationId` (string,null)